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General Description 


Several installations have expressed a need for main storage 
resident common area. This common area can be used to keep 
Vital information which can be accessed by all the terminals. 
Records in this area will be lockable and recoverable. 
Criteria for the support of common area ‘is efficiency, 
flexibility, and ease of use. We are proposing, that common 
area be a main storage resident ISAM file. It is a multi- 
record file. User can issue GET, GETUP or PUT on any record 
of this file as he currently does for an ISAM file. IMS 90 
record locking procedure will hold for this file. os 
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a. 


: b e 


c. 
d. 


a) 


: Configurator 


To implement the common area Feature the. fod tousng EoMponent= 


IMS 90 are affected: nos P pytt 
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= eer 


foe ~~ woa = 
‘Configurator "22 242 Somezrs DeVefoumen i: Cenisi 
Startup — is at 
On-line \i fe PEE ee A We eee 
Shutdowm 2s See ee : 
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Common area Ts Wain Storage resident, variable blocked on 
fix blocked ISAM file. “Any number_of files “can be main_- 





storage resident. Beside supporting: the current options 


in the FILE section, two additional keyword parameters 
are supported fof common area file. ~~ i 


© CAFILE ps} ep. ; | 


¢ 





2orit omer 


file is a common area file. Default. -is- "NO. - “TF CAFILE= YES 
is specified, then cont gucctar will set the bit X'80' 
in the flag byte ZF#FFLG2 of the File Control Table (FCT). 


-@ CUPDATE =5 YES 


This option will allow the user to specify whether updating 
of the disk images is. necessary.- Default is NO. If YES 
‘option is selected, a bit in che: FCT (bit X40" byte 
ZE#FFLG2) is set. : 


e TRACE = NO option will be valid for common area . 


files. : cacamed 
e@ If ‘LOCK’ = UP zis “specified, eheh no before, “images: 
are written tothe ‘AUDIT. $e 1 eee -no-on-line - Tecovery: 


takes place in case ae any error in the user seston program. 
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by Startup So eee 
"During startup irocedure of IMS 90,° ‘common data area =7* 


file will be loaded in main storage. For error diagnostics, 
be refer to technical documentation by P. Retenmuens: verte bs 


~¥ 
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ey ~On- Line Processing | ee 
ica User is allowed ‘to issue GET, GETUP, and PUT IMS 90: - 
“> > function calls for ‘a common area file. ALL ‘the eREntceete 


Ook te 
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d) 


ELror codes | are ‘posted in the PABST jus 


e: On-line and off-line recovery procedure is valid 
‘for common area files if user chooses recovery  <-7~-: 
‘options. ; 

“¢ Common area file requests are handled by the common 

>’ data area modules (ZF#CSAS for S/T and ZF#CSAM for 

>_""M/T). The general request processor module will 
“~ pass control to the Sppeepraere common data area 
ie mente: 





-e_ No changes are required to on-line Peeve ty? or roe 
Rp ‘Tecovery- or. warm Festart. — eas ae : . 


“Baring *epucdeuad ‘Gommon data area s files wai be updated 


(using . the data_ in. main Bee eager 
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1. 


1.1 








TITLE 

ZFECSAS. This module handles all requests to a CSA*-file in- 
‘MEMOry: for single thread IMS epee - Sirah ee sae es 

*CSA = ececnimon<storacesAcea BPE TOSS, ARS wret Rev se ue ae 
Purpose 


no 2 es ard a mate Poet -aaees 


Several inetalvecione have expressed a ened for fain? storage . 
resident common area. ‘This common area can be used to keep 
vital information which can be accessed by all the terminals. 
Records in this area will be lockable and-recoverable.~ 
Criteria for the support of common area is efficiency, 
flexibility, and ease of use. We are proposing, that common 
area be a.main storage resident ISAM file. It is a multi- 
record file. User can issue GET, GETUP or PUT on any 

record of this file as he currently does for an ISAM file. 
IMS 90 record locking procedure. will hold. for this foe 
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2.2 
2.2.1 


Been chee and bit vs of Z2F#FFLG2 is checked if it is on (X'8H' ). 


’ STARTUP 


DESIGN DESCRIPTION FOR COMMON DATA AREA 





General“. =") ee 


_The following modules manipulate ‘the requests to ‘the CSA files which 
are in memory. 


Pe ere +t wee te mnemeer ws ce 


2 lI" ZBeSTRTN during Startup processing 
_. BFHGEN/ZFHCSAS during On-Line ; 
“2 gpasnury te during Shutdown Processing 


Beeore the aeauie ZFHGEN branches into ZF#CSAS, the FCTs are 


If there is an occurrence, control is given to the staresiapel of 
ZFHCSAS with a BALR instruction. Following the BALR, a half-word 
value indicates from where control came. : 


Values of the Halfword : 


Set_by/for | 


eo oe Pee 
On-Line GETUP/PUT/GET 


On-Line Termination , 7 Se 
On-Line Cancel -_ 





Fiqure 2.1 


Moment of Loading 


Because the original CSA-files could be affected by a restart 
facility, loading of the records into memory starts immediately | 
before Startup branches to Phase 2 of IMS 90. 


Due to this reason, the high address of the storage pool has to 
be carried to this point ipeetorng of BCOReECr = into ZBHMEHI at 
line 4499). 


Memory Allocation for CSA 


The item ZTHHPIBA of the THCBcontains the first free location in the 
storage pool. This will be the Start Access of CSA. To allow 

IMS to load subsequent nonresident Action Programs, 8K are kept 

free at the top of storage pool. During the load of the CSA-records, 
this area is used as I/O-area for the CSA-files. 


The CSA Start-Address (contents of ZTHHPIBA) will be stored into a 
new added fullword in the GEN-module (ZFHCSADR). ZTHHPIBA in the 


THCB will be updated after. successful CDA-load. 
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2.2 
2.2.1 


peor chee ene. Boot a9 BS of ZF#FFLG2 is checked if it is on (X' 8B" ). 





Nee Cee eS Bare, “a eee 


General: °. = pele 


The following modules manipulate “the requests to the CSA files which 
-are in memory. 


. ZL gBeSTRIN during Startup processing 
e-g-,BFHGEN/ZFHCSAS — during On-Line 
: "2 gpisuurN - during Shutdown Processing 


Pekore the module ZFEGEN branches into ZF#CSAS, the FCTs are 


we ie - o- 


If there is an occurrence, control is’ given to the Ueaeerabel of 
ZFHCSAS with a BALR instruction. Following the BALR, a half-word 
value indicates from where control came. : 


Values of the Halfword | 


Set_by/for . 


. i 7 ¢ * 
On-Line GETUP/PUT/GET 


On-Line Termination ae . = 7 
On-Line Cancel 





Figure 2.1 


" STARTUP 


Moment of Loading Pec eee oe a see 


Because the original CSA-files could be affected by a restart 
facility, loading of the records into memory starts immediately 
before Startup branches to Phase 2 of IMS 90. 


Due to this reason, the high address of the storage poot has to 
be carried to this point iresroes ng of Pegserer- Sank ZBHMEHI at 
line 4499). 


Memory Allocation for CSA 


The item ZTHHPIBA of the THCBcontains the first free location in the 
storage pool. This will be the Start Access of CSA. To allow 

IMS to load subsequent nonresident Action Programs, 8K are kept 

free at the top of storage pool. During the load of the CSA-records, 
this area is used as I/O-area for the CSA-files. 


The CSA Start-Address (contents of ZTHHPIBA) will be stored into a 
new added fullword in the GEN-module (ZFHCSADR). ZTHBPIBA in the 


THCB will be updated after. successful CDA-load. 
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2.2.3 Memor La out: before CSA-Loading _ 














oa ee IMS 90 
_ a - Root. and Phases _ . 
ZTHHPIBA point arr 








ese Pa free memory 
2 BHMEHI points to 
Das : Dias Ss 6 rea a ie rare “8Iqure 2 2 Se ee - ; “ea 
° T an a ao: , ae : tue ee: : 
2.2.4 Memory Layout after CSA-Loading “""-"" ae ae ae 
~ — SSeS eee IMs” 9 0 ee rea ; 
oe on ‘ Root and Phases - 
ZFHCSADR points to Sg a wha 3 
ZTHHPIBA points to. ie ae 2 


Remaining free 
_ storage 


—- ot oe ee eet eee te 


8K temporary storage during load-process used for 


fI/O-area for the CSA-files 






Input Staging Buffer 


Resident Action Prog. 


M6225 oe Procedure 


All FCT's are sequentially searched for the x' 8p" value in the 
& ZFHFFLG2-byte. 


If such an FCT exists, the corresponding file is pasa sequentially 
into memory. The format of the memory CSA-file is shown in 


Figure 2.4. 


2.2.6 Format of the CSA in Memory 
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Mt ZFHDCSFT | Filetype 
4 ZFYDCSFN | Filename Copy of ZFH#FNAME 
x ZFHDCSFL | File length in bytes 
3. ZFHDCSIX Index Table Address 
3 
Dv bs tae ge Copy of ZCH#TTRID 
ba Identification Renee = eee 
: Record-length (if variable) 
Ry : 
Key and Data of Record 

a a 
aH End of curreht file 
7 End of CSA 
O. > , 
D, 3 

* See figure 2.5. 4 ** See figure 2.6. 
2. 2. 7 Filetype Byte in the CSA ame? ie aa eee = 


iy 


ee C LOCK = TR |LOCK = UP CUPDATE = YEQCUPDATE = NO Filetype - 
alue 








ie i) | 





. Fiqure 2.5. 





ee ee mee me ee 
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e = 
-Filetype-Byte: Bit @ 7) TRACE = YES 
: a 1 TRACE = NO. 
@ pte Pe oe 6, . ‘Bit 1 g LOCK = TR (Recovery wanted) 
7 - 1 . LOCK = UP (No recovery wanted) 
- : Bit 2 g CUPDATE = YES — 
= * 1 CUPDATE = NO 
- = + wee Bits 3-6 always $ 
‘u * CO BA 7. dB ~Fixed length records  «- ___. 
" 1 Variable length records 
2.2.8 Failures Rete ee eet Se ee PRR eee ean ate! 


There are two possibilities a failure can occur during load: 


- I/O Error on a specific CSA-file 


- not enough memory available to hola all records of a file 
_ in memory 


(Aor ee ee 


For both cases, the stecady used memory for that file is released 
and bit % of ZFHFFLG2 in the corresponding FCT is reset. (The 
uaa will be a normal file for the future Brocco Par 
r A warniag message is-issued for the ‘appropriate error “and processing 
~-r~—-~- Continues. 


Son” 


W CSA LOAD 1/0-ERROR FOR FILE *--------* oa 


‘W.CSA LOAD ERROR FOR “FILE #..------* | MEMORY EXHAUSTED — 


2.2.9 Restriction on ene 1/O-Area-Size of CSA-Files 


Due to the use of the "dummy-reserved" 8KB block as I/O-area 
for the CSA-files, blocks may not exceed this value. 


. 
ry ome nity ce re ees = ie 
ee were seems 6 Ne 
er ee ee a er ed iS ty P25 Ss we ae, ©: ” 
es oe termes: . > = = : : + o3 « . 
7 . s € . . 
enemies et meee 6 ee perme aes nr er TD NEE Ni RETR Se Let ce ene mene em ceme | ememnenene — 
: : rs om, ~ LS eras. 
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id = * oe - 
y 6 . . F oa ~ . . 
¢ enthe ntNORS bo ee ee eh e wn gERe we awe ree. : Re Rey Or ee QE ee» aap ee NE eee: ome ene ee te 
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--Filetype-Byte: Bit g 2 TRACE = YES 
| ~~. 1 TRACE = NO. 
& og . ‘Bit 1 g LOCK = TR (Recovery wanted) 
3 : 1 . LOCK = UP (No recovery wanted) 
- Bit 2 g CUPDATE = YES es 
ca 1 CUPDATE = NO 
- es nw eens Bits 3-6 always g 
°° CO Bt 7. 2 =. = Fixed length records - 
2 1 Variable length records 
2 e 2 ry 8 Failures = iets Seas eee 4 See ge eee, ea oe oe Ore mee at on eee a ee 


There are two possibilities a failure can occur during load: 


- I/O Error on a specific CSA-file 


- not enough memory available to hold all records of a file 
in memory 


cen emenae aimee ap meme oe 


For both cases, the already used memory for that file is released 

and bit @ of ZF#FFLG2 in the corresponding FCT is reset. (The 

reneeste will be a normal file for the future pecan rae 

A warning message is: issued for the ‘appropriate error “and processing 
~c~e--=-=-Ccontinues. 


W CSA LOAD 1/0- ERROR FOR FILE *-------~* Mics 
-W. CSA LOAD. ERROR FOR FILE Piette aia * MEMORY EXHAUSTED 


ed 


2.2.9 Restriction on “he eee of CSA-Files 


Due to the use of the “dummy-reserved" 8KB block as I/O-area 
for the CSA-files, blocks may not exceed this value. 


wie amy re eee eee 
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3 On-Line - : ; a 


e351 0 General. 2 saeco a - 
Si ®@. ZFHCSAS is- invoked by three kinds of requests: 
- normal requests like GET, GETUF. | or. PUT from. user. = o£: 


caction programs.-.. . 2 w:n:2 t1.iir 22: 
— Rollback functions (GETUP and- put) requested Sy ne Se yo 


* 'ZSHROL action program ~~ teks 


oe = Sato termination of an action/transaction a aoe s (eae ee 
ar Sire ae eer ae pet ee ee 


2.3.2 Normal iuncaqezes for CSA ee es 


a) Control flow ‘for an update ie 


““Action ‘Program 





+] 
eae ms ane : ~ 
wanes 
cremate pwmesede smee a3 
~ ~~ = ot cone -, ook nee ses teens 
. 
° F: ie 7s ~ - ~— = we 
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EO tet he eS ene te. inne ae EE NS LD eee ar BR Oe ee 


SB crete Mm he ree es tec emere: - emma te. enn oe mene tom — 


GETUP 


owe 


& 1. . The action program issues a GETUP for a CSA file. Control 
is passed to the GEN module. 


é @ ne gees 2 aoe ~- -~- stan: 


26 GEN_ passes « conereL. to ZFHCSAS, which Tocates ‘and retrieves 
the specific record to the user's work area and manipulates 
~ the jock for. the record. POM Ble ice Eee ee OTH 


3-4 Control: returns to-the action, program. --- 


‘. Put 


‘Le The aetion program issues a PUT for a‘CSA file. Control is | 
pPeeees: to the GEN module. 


a GEN. “passes control to ZFHCSAS, Which locates and retrieves 


i° the specific ‘record from the user' s work area to the CSA. 


3-4 Depending.on the filetype-byte in the CSA, ZFHCSAS activates 
2FHITR to write before and after images to the trace file. 

5-6 andioe Borers images cS the audit file with. the ZPHSATAU 
module. 


ewer 





eet oe - nr a 


When control returns to ZFHCSAS and the CUPDATE=YES option 
@ ‘was specified, the specific record is written back to disk. 

' Finally, the: main-storage-record will be changed angi if 
lock=up is specified, the lock released. eons Sz 


Ret a ee ee ca 


Dae 


71-8 Control returns to the action program.” 
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2.3.3 


2.3.4 





b) Control flow for a GET 


‘Action Program 






1. The action program issues a GET for a CSA file. Control 
is passed to GEN. 


2. GEN passes control to 2FH#HCSAS. The specific record is 


read out of the CSA and written into the specified or abes ce 
‘user work area. 


3-4 Control returns to the action program. oe ss 


Rollback Functions from ZSHROL 





If bit 6 of ZCHTST1 in the terminal control table (TCT) 
(x'#2'= Rollback in Process) is.set, it can be determined 

if the request comes from ZU#ROL. ; . 
The same control flow applies as for a normal update request. 
(see 2.3.2), except that no before/after images are written to 
the audit/trace-file. . 





Termination of an Action Transaction. 


Action 
Program 
ft 





2-45 
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1. An action terminates. (e.g. - PC, abnormal or normal 
>  -termination). Control is passed to the GEN module. 


2. GEN activates ZFHCSAS to release all pending locks for 
this transaction.  — -...:.- 


en ne ee 


3. Control is returned to,-GEN. 


Record-Lock-Mechanism in Memory. 


As described in Figure 2.4, each record in memory is prefixed with 
an 8 byte identifier, which-tells from whom the record was locked. 
Every time a CSA-record is updated by a GETUP-Request, the specific 
record in memory is locked:. 

- the field ZCHTTRID of the ‘TCT is eogiee into the 

identification field of the CSA-record. 

During a GETUP, the vecoral. is not read from disk, although CUPDATE= 
YES is specified. If a user issues a GETUP on a locked record, 
the status and detailed ‘status— codes‘in the PIB are set to 3, 


.yespectively 18. 


The locks are released after a successful PUT or at Action/ 
Transaction ‘Termination by ‘clearing “the -identifier-field <in the 
CSA to zeros. . : oe 


Shutdown: 34> os sesen se SO Ce ese ge. Sie Bee siee ss Semees 22 


When ‘the ‘system comes to Shutdown, all--records of every CSA mémory — 


_, file with CUPDATE=NO parameter specified are written back to disk 
‘> sequentially. _This_is done by searching the FCT's for the Z22#FFLG2 


X'80' value. =r aR SS vei ae fces tee ties eee either Mob Seah R Bley pee en. eee S . 2 we 


ca a or 
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Failures - Lien 2 PSs = 


Because of a failure, two types of actions can occur: 
-. termination of processing for the current file. 


-' = termination of processing for. all subsequent files 


a) Termination for current file | 
- If£ an I/O-error occurs: 
W CSA UNLOAD I/O ERROR FOR FILE * + 
- If a key in the. CSA does not eter with the key on disk: 


W CSA UNLOAD INVALID KEY ‘FOR FILE * * 


- I£ there are more records in memory than on disk: or vice versa 





W CSA UNLOAD INVALID # OF RECORDS FOR FILE * * 
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“b) ‘ernination for all “subsequent - files: 


~ If a. filename of |i a CSA-file in ‘Memory is inexistent in 
“=the FCT's Sane a oierge eS 
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, 4.2 


* INTERFACES 


As déseribed - in 9, 1., CSA fopetiene: ‘are used in 3 different qodules: 
The following entry and exit conditions apply: 


oe 


Entry. Conditions — 


~ . : ae aR Srey ee 


[a a 






of THCB ZOQHTHCB 
of TCT 
of FCT 


of DTF 









ZBYSFCTI/ZFHFCTA 










aram-List—Address 
Address of PIB 


Address first free 
byte in storage 











ZTHHPIBA 











Address last free ZBYMEHI 


byte in storage 









Address I/O area 
CSA file 


Address of CSA 
start 


‘Gontehes ZBHMEHI 
+1 





ZFHCSADR}| ZFHCSADR |ZFHCSADR 


Exit Conditions 


After Startup, ‘the fields ZTHHPIBA and 2PHCSADR: are adjusted. 


‘The registers remain unchanged except RES and RFS. 


The return-address is picked up from a table in ZFHCSAS, depending 
on the displacement value following the BALR instruction in the 
calling module. 


ce 


BALR RES$,RFS | DC V(ZFHGTTS) ON-LINE 
pc H'g! 
BALR RES,RFS$ 
pc H'4' 
BALR RES,RFS 
pC H'8! 


DC V(ZFHGRTN) TERMINATION 


DC V(ZFHGTCN1) | CANCEL 


Coding is calling Program = Table in ZFHCSAS (Return-—Address) - 





4.3 


4.3.1 


4.3.2 


Beet 


2 re 


External: References 


ee 


The following modules are cee during processing of ZFH#CSAS: _- 


COR 











pac ZPRITR « «- Write before/after images to Trace 
 SPHSATAU Write before image to Audit 
ZFH#GSR Allocate I/O area from Storage Pool 
(ZFHGEN) i 
bntce/uaie Conditions for _2¥HTTR- = is eee or, . ie er : 
R3$:--... -= Address of FCT user file ee se eke 
R45... -: Address user DTF _ : ane po Sacre is 
RAS... =: “Address TCT. -r-rcsrserccp nts ; oe re 
RBS... - -: -Address THCB ~- oe Sees as aes 
RC$.. .. -- Address PIB 3h. = ae Be au 
DD$KLE. _-.. Must contain key. length toe ae io 
DHSSPB -- -Must contain record size rar! rn: oe 
DHSKLC =. Must contain key -location - 2 ee = io 
QT#HRPLA =* “Must contain parameter list address 7 a 
ZTHHEWA — fic cag “Packet - =(2 fullwords)_ ae _ Pa | — 
a -,: Byte ls -83. -ISAM-before image _ = ese a 
tae a ‘8B ISAM after image ee a oR 
siivcc: tt Byte 2s ' 99 Update _ = Basse. Seeeae ee sg 
Sd _Byte 4-7: Address of key argument : | 
Entry/Exit Conditions for ZFHSATAU ‘ 
R3$—CO “ Address of FCT of the User File 
R4$ sone Address of the “user DTF ©. 2 7 TRD A ae. notions ¢ 
RAS °.. Address of the user TCT *3 |... These registers can 
RBS }: - Address of the user THCB er aaa from the 
Rc$ Address of the user PIB tok hE elt tide 
DHSKARG must contain Address of the key argument 
ZFHMRN must contain record length of the user-record = = 
ZFHREC must contain record address of user record eee <r : 
2THHFWA must contain X' $3' to indicate ISAM request . _ 
ZTHHFWA+4 must contain key argument-address ak a 
DDSKLE must contain key Lenaxh. ey ; Sees. ste eas S ea 


4.3.3 Entry/Exit Condition for ZF#GSR 


. R3$ - Address --BCT ie Use, Ser seee Surat. s Teens = zs 
& RB$ Address THCB ; 
ZFH#FIGS must contain the size of ‘the requested t/o area. 


After ‘exit of ZFHGSC: ~~~ ee ae ee — 


: R6$ contains the address of the allocated I/O area 
R7$ is destroyed 


AAA. System Macros used for | CSA: Processing 


SETL ‘Stare ‘sequential getrieval (startup/Shutdown) 
ESETL End sequential retrieval (Startup/Shutdown) 
GET Read record sequential (Startup/Shutdown) 

PUT ‘Update record sequential (Shutdown) 

READ Read record randomly (On-Line) 

WRITE © Write record randomly (On-Line) 

WALTF ~~ Wait on ‘1/0 completion ; 


Bee ee eee poor ee - ee 


£ oes Oe. ae 2 Ve SSS = Sells 
oe oe faa eles: ~~ ae Pe Be Le os = 
a bed _ -_ 
ike os = = SPS > = om ee Ie _— 
ee = Seas Ss is aX ae 
is , 
‘Treen = a <ieet -—otx Weteew en tre K~s 
Lf -_ ed _—— _ wee ewe ewe Oe 
or —- sea, Mitac! deter SO 
as -_. a era ay Bee a = 
Sey i Se fs eo ee) 
pains = - a 
Trev 7 7 Rtarecs g2 Ken ercument 
Se one EES Ss woe es ee aes =a pane Sete 
5 Gist oe _ ~ - - ~- 
~ - het 2 
: ‘ Bs 
ie ~ ; 5 
7 © 
ig ~~ 
. = o-- : 


owe’ 





Data SS 


‘This module does not ne 
‘added Flag-Byte in the 
indicates whether a 


ZFHFFLG2 - values? BIT @ g 
Sraaitee: ees = ‘< Soe Rave, PPT ee aon eS 1 


Sey 


“The format of the generated 
is seen in Figure i 


Loe, Gero 
beer ee aL ce et per areas Ss 


- eee - : 
Be tee eo ae 5° 
- 

eesti’ : hs Oo 

wwe s Hos S ~ 

weer : 

o View eae tes tod ae 

one eee ee = 
aes . = 

Foo ee Reel rer 

emer ‘s . 

Tioee Pee See Se 

esp eore 2 . 

foes Ste fe os 

a id tone ~ - 





,ATA“REFERENCES- © ~~ 


ed any new external data except a new 
File Control Table (ZFHFFLG2), which 


file is a CSA file or not. 


normal file 
CSA file 


nll 


i 


no disk update 
=. disk update performed 


comma-storage-area in main storage 


myeorrt wee el = 
_s a = we sie 
Se. coe 


= = i iad 
an? 
3 
s 
ao a 
3 


STORAGE MAPPING 


The coding for the CSA processing is divided in three aceon 


Startup-Coding. This coding is part of the ZBYSTRTN module 
and for this only during Startup in memory. 


Onehine-codiag: This coding is an own "module (ZF CSAS), which 


is part of the Root-Phase of IMS/90. The Start-Address of 


the CSA. is stored in this module. 


Shutdown-Coding. This coding is. part of the ZBH¥SHUTN module, 
and for this only during shutdown in memory. . 


The Common-Storage-Area location is shown in Figure 263% 


ee eee ot meee memes + 


AVAILABILITY, RELIABILITY AND MAINTAINABILITY 


pvailabiiiey 


Ag: Wieser ibed in 2. o. 3, a “Sailuce at “the. “loading eoceauee. does 
not force IMS to fail too. Processing can continue and it is ; 
the operator's decision to continue with that environment or .<°. 


cheege anes ST eee ea hoe oD Ce eae Si eee Sees es. Se 


ae ~~ ce Bie De Oo meee -- we tee LY -- wee 7 éN Bee ee 


Reliability 


Scotto Saha a a ee a a a a eee er gt: 


Recess” to CSA data is ‘done -in the very same “way as a normal 
I/O request. (GET/PUT level). The user does not notice the 
existence of the CSA facility in his action programs. ~.:. 


Just so, the same error conditions occur as with normal requests. 


For error messages, refer to 2.2.8 and 2.4.2. 


Maintainability 


Very few modules are touched by the CSA option. Beside the Startup 
and Shutdown processing, all requests are handled in an own module, 
which is called from ZFHGEN only. Thus, corrections and/or 
enhancements have to be done in “aour modules. (ZBHSTRTN, ZBHSHUTN, 
’ -BPEGEN, aa ath tn tte Le eee cod ating 


cet wee ee wees toe Cn ars 
. ° 


¢ 


ig “ 


8.2 


8.3. 


8.4 


8.5 





Type of Code 


" IMPLEMENTATION CONSIDERATIONS 


Serially reusable. ° . . E 


em. 


Source 7 anguade: 


Series 90 Assembler. 


System Genccdeion : 


None. 


coding Constesinbe 


Will be supplied. 


Conventions and Standards 


PY a 3 aaa number. 


are usage: 


s i a 


R3$ 
R4$ 


 RSS-ROS - 


RA$ 

RBS 

RC$ 

RD$ 
RES+RF$ “ 


Cover 
FCT 
DIF 
free 
TCT 


. PHCB 


PIB... 
S.A. 
branching 


register 


Ail papers: “in the module start with ‘the REPSE ss ZFHCS followed 


TOO RT CO tM meee Tet 


2 tos omen aan. npmcmmtnin sume 


